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PREFACE 


This  product  specification  covers  the  work  performed  under 
Air  Force  Contract  F33615-80-C-5155  (ICAM  Project  6201).  This 
contract  is  sponsored  by  the  Materials  Laboratory,  Air  Force 
Systems  Command,  Wright-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Gerald  C. 
Shumaker,  ICAM  Program  Manager,  Manufacturing  Technology 
Division,  through  Project  Manager,  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company,  Schenectady,  New  York,  under  the  direction  of 
Mr.  Alan  Rubens te in.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Automation  Systems  Department, 
Albany,  New  York. 

Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  Integrated  under  Project  6201 
for  publication  and  treatment  as  an  integrated  set  of  documents. 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR620100001 ,  Project  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TASK  4.2 

Subcontractors 

Boeing  Military  Aircraft 
Company  (BMAC) 

D.  Appleton  Company 
(DA00M) 


General  Dynamics/ 
Ft.  Worth 


Role 

Reviewer . 


Responsible  for  IDEF  support, 
state-of-the-art  literature 
search . 

Responsible  for  fantory  view 
function  and  information 
models . 
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Subcontractors 

Illinois  Institute  of 
Techno 1 ogy 

North  American  Rockwell 
Northrop  Corporation 

Pritsker  and  Associates 
SofTech 

TASKS  4.5  -  4.9  (TEST  BED) 

Subcontractors 

Boeing  Military  Aircraft 
Company  (BMAC) 

Computer  Technology 
Associates  (CTA) 

Control  Data  Corporation 
(CDC) 


D.  Appleton  Company 
(DACOM) 


Role 

Responsible  for  factory  view 
function  research  (IITRI) 
and  information  models  of 
small  and  medium- size  business. 

Reviewer . 

Responsible  for  factory  view 
function  and  information 
mode 1 s . 

Responsible  for  IDEF2  support. 
Responsible  for  IDEFO  support. 


Role 

Responsible  for  consultation  on 
applications  of  the  technology 
and  on  IBM  computer  technology. 

Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 

Responsible  for  the  Common  Data 
Model  (CDM)  implementation  and 
part  of  the  CDM  design  (shared 
with  DACOM). 

Responsible  for  the  overall  CDM 
Subsystem  design  integration 
and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DACOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems . 
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Subcontractors 


Role 


Digital  Equipment 
Corporation  (DEC) 


McDonnell  Douglas 
Automation  Company 
(McAuto) 


Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation . 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 


On-Line  Software 
International  (OSI) 


Rath  and  Strong  Systems 
Products  (RSSP)  (In  1985 
became  McCormack  9  Dodge) 


Sof Tech ,  Inc . 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamics 
Research  Corporation 
( SDRC ) 


Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 

Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Network 
Transaction  Manager  (NTH)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems. 


Other  prime  contractors  under  other  projects  who  have 
contributed  to  Test  Bed  Technology,  their  contributing 
activities  and  responsible  projects  are  as  follows: 


Contractors 


ICAM  Project  Contributing  Activities 


Boeing  Military 
Aircraft  Company 
(BMAC) 


1701 ,  2201 ,  Enhancements  for  IBM 
2202  node  use.  Technology 

Transfer  to  Integrated 
Sheet  Metal  Center 
(ISMC) . 
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Contractors 

ICAM  Protect 

Contributing  Activities 

Control  Data 
Corporation  (CDC) 

1502,  1701 

IZSS  enhancements  to 
Common  Data  Model 
Processor  (CDMP). 

D.  Appleton  Company 
(DACOM) 

1502 

IISS  enhancements  to 
Integration  Methodology. 

General  Electric 

1502 

Operation  of  the  Test 

Bed  and  communications 
equipment . 

Hughes  Aircraft 

Company  (HAC) 

1701 

Test  Bed  enhancements. 

Structural  Dynamics 
Research  Corporation 
( SDRC ) 

1502,  1701. 
1703 

IISS  enhancements  to 

User  Interface/Virtual 
Terminal  Interface 
(UI/VTI ) . 

Systran 

1502 

Test  Bed  enhancements. 
Operation  of  Test  Bed. 

Vi 
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FOREWORD 


This  is  the  second  bound  segment  of  two  comprising  Volume 
VIII,  Part  21  of  the  Final  Technical  Report.  It  contains 
Sections  3.10.9  through  4.2. 
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3.10.9  Include  File  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  listed  in  3.10.4  as  specified  in  the  source 
code.  The  language  it  is  written  in  is  also  given. 
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REPORT  WRITER  Include  File  Description 


FILE  NAME:  CHART 

PURPOSE:  CHART  INCLUDE  FILE 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

GLOBAL  DECLARATIONS  FOR  CHART. 
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REPORT  WRITER  Include  File  Description 


FILE  NAME:  CTLCHR 

PURPOSE :  CONTROL  CHARACTERS 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

DEFINITIONS  OF  ALL  CONTROL  CHARACTERS  TO  AVOID  CHARACTER 

SET 

DEPENDENCIES. 
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REPORT  WRITER  Include  File  Description 


FILE  NAME:  ERRPRO 

PURPOSE:  PROCESS  ERROR  IHCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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REPORT  WRITER  Include  File  Description 


FILE  NAME:  FFFV2 

PURPOSE:  FORM  FILE  FORMAT  -  VERSION  2 

LANGUAGE :  C 

DESCRIPTION : 


DESCRIPTION 

j  RECORD  LAYOUTS  FOR  THE  BINARY  FORM  DEFINITION  FILE 

< 


I 

* 


11 


I 


t 
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REPORT  WRITER  Include  File  Description 


FILE  NAME:  FLAN 

PURPOSE:  FLAN  INTERNAL  STRUCTURES 

LANGUAGE:  C 

DESCRIPTION: 


DESCRIPTION 

AUXILIARY  DATA  STRUCTURES  USED  BY  FLAN. 


<  >.i  <,?  *.i  <»*.* 
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REPORT  WRITER  Include  File  Description 


FILE  NAME:  FPCODE 

PURPOSE:  FORM  PROCESSOR  RETURN  CODES 

LANGUAGE :  C 

DESCRIPTION: 


3-442 
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REPORT  WRITER  Include  File  Description 


FILE  NAME:  FPD 

PURPOSE:  FORM  PROCESSOR  DATA 

LANGUAGE:  C 

DESCRIPTION: 


DESCRIPTION 

DATA  DEFINITIONS  FOR  ALL  FORM  PROCESSOR  (INCLUDING 

MONITER)DATA. 
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REPORT  WRITER  Include  File  Description 


FILE  MANE:  FPDINI 

PURPOSE:  FPD  INITIALIZATION 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

INITIALIZED  VERSION  OF  UID  FOR  INCLUSION  IN  MAIN  PROGRAM. 


i 
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REPORT  WRITER  Include  File  Description 


FILE  NAME:  FPPARM 

PURPOSE:  FORM  PROCESSOR  PARAMETERS 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION:  THESE  DATA  DEFINITIONS  ARE  USED 
IN  THE  FORM  PROCESSOR  ROUTINES. 


t  *.1" 


t  ‘j 
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REPORT  WRITER  Include  File  Description 


FILE  NAME:  HRWFRM 

PURPOSE:  HRW  FORM  DEFINITION 

LANGUAGE :  C 

DESCRIPTION: 
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REPORT  WRITER  Include  File  Description 


FILE  NAME:  NTM 

PURPOSE:  NTM  INTERFACE  INCLUDE  FILE 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

INCLUDE  FILE  FOR  NTM  INTERFACE 


’ 

l 

I 
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REPORT  WRITER  Include  File  Description 


FILE  NAME:  RW 

PURPOSE:  REPORT  WRITER  DEFINITIONS 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 


5 


4 

X 
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REPORT  WRITER  Include  File  Description 


FILE  NAME:  SRVRET 

PURPOSE:  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED  11/2/83  TO  INCLUDE  RET -CODE -5 
MODIFIED  1/9/84  TO  INCREASE  ALL  ERROR  CODES  TO  PIC  X(5) 
AND  TO  ELIMINATE  ALPHA'S 

MODIFIED  1/26/84  TO  ADD  RET-CODE  FOR  GETUSR-NOT-SUCC 
SRV-SUCCESSFUL  ADDED  FOR  GENERIC  RETURN 
MODIFIED  2/7/84  TO  ADD  ERROR  CODES  FOR  ENTRT -NOT -FOUND 
MODIFIED  2/8/84  TO  ADD  WHTHST-NOT-SUCCESSFUL 
MODIFIED  2/20/84  TO  ADD  TSTMOD  NEW  CODES. 

MODIFIED  20  AUG  84  INITALIZE  ALL  LOCAL  VARAIBLES  TO 
SPACES  OR  0 

MODIFIED  5/21/85  TO  ADD  RCL  AND  FILGEN  RETURN  CODES 
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REPORT  WRITER  Include  File  Description 


FILE  NAME:  STDTYP 

PURPOSE:  STANDARD  TYPE  DEFINITIONS 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

THIS  FILE  ENSURES  THAT  THE  FOLLOWING  STANDARD  TYPES  ARE 

AVAILABLE: 

FLOAT  -  SINGLE  PRECISION  FLOAT 

DOUBLE  -  DOUBLE  PRECISION  FLOAT 

LONG  -  32  BIT  (OR  LARGER)  SIGNED  INTEGER 

LBITS  -  32  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 

INT  -  NATURAL  SIZE  SIGNED  INTEGER 

UNSIGNED  -  NATURAL  SIZE  UNSIGNED  INTEGER 

BOOL  -  NATURAL  SIZE  LOGICAL  (ZERO  /  NON-ZERO  f NLY ) 

SHORT  -  16  BIT  (OR  LARGER)  SIGNED  INTEGER 

USHORT  -  16  BIT  (OR  LARGER)  UNSIGNED  INTEGER 

BITS  -  16  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 

CHAR  -  SINGLE  MACHINE  CHARACTER  (REAL  CHARACTERS 

ALWAYS  POSITIVE) 

TINY  -  8  BIT  (OR  LARGER)  SIGNED  INTEGER 

UTINY  -  8  BIT  (OR  LARGER)  UNSIGNED  INTEGER 

TBITS  -  8  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 
TBOOL  -  8  BIT  (OR  LARGER)  LOGICAL  (ZERO  /  NON-ZERO 
ONLY) 

METACHAR  -  16  BIT  (OR  LARGER)  AUGMENTED  CHARACTER 
(SIGNED) 

VOID  -  FUNCTION  THAT  RETURNS  NO  VALUE 

FORTRAN  -  STORAGE  CLASS  FOR  FOREIGN  (NON-C)  ROUTINES 
OR  C  ROUTINES 

WHICH  ARE  CALLABLE  FROM  FOREIGN  ROUTINES 

SINCE  NOT  ALL  COMPILERS  SUPPORT  USHORT,  TINY,  AND  UTINY, 

THE  FUNCTIONS 
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USH0RTO,  TINYO,  AND  UTINY( )  SHOULD  BE  USED  WHENEVER 

REFERENCING  THEM. 

IN  ADDITION,  THE  FOLLOWING  UTILITY  MACROS  ARE  DEFINED: 
LURSHIFT(N,  B)  -  UNSIGNED  LONG  RIGHT  SHIFT 
MAX( A ,  B)  -  MAXIMUM  OF  A  AND  B 

MIN( A ,  B)  -  MINIMUM  OF  A  AND  B 
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REPORT  WRITER  Include  File  Description 


ABS(A)  -  ABSOLUTE  VALUE  OF  A 

STRASN(A,  B)  -  TRANSPORTABLE  A  -  B  FOR  STRUCTURES 

NULL  -  NULL  POINTER  VALUE  (0) 

TRUE  -  1 

FALSE  -  0 

SUCCESS  -  EXIT( SUCCESS)  INDICATES  SUCCESSFUL 

COMPLETION 

FAILURE  -  EXIT( FAILURE)  INDICATES  ERRORS 

THE  FOLLOWING  SYMBOLS  SHOULD  BE  DEFINED  BASED  ON  THE 

COMPILER  BEING  USED: 

USHORT  -  COMPILER  SUPPORTS  UNSIGNED  SHORT 
TINY  -  COMPILER  TREATS  CHAR  AS  SIGNED 
UTINY  -  CHAR  IS  SIGNED  AND  COMPILER  SUPPORTS 
UNSIGNED  CHAR 

VOID  -  COMPILER  SUPPORTS  VOID 
FORTRAN  -  COMPILER  SUPPORTS  FORTRAN 
STRASN  -  DEFINE  APPROPRIATE  MACRO 
SUCCESS  -  DEFINE  APPROPRIATE  VALUE  IF  NOT  0 
FAILURE  -  DEFINE  APPROPRIATE  VALUE  IF  NOT  1 
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3.10.10  Hierarchy  Chart 

The  following  hierarchy  charts  show  the  relationships 
between  all  of  the  nodules  mentioned  in  the  above  docuaentat i on . 
A  aodule  aay  call  a  subroutine  several  tines  within  its  code, 
but  the  call  will  only  be  shown  once  as  a  single  relationship  on 
this  hierarchy  chart.  All  nodules  shown  at  the  top  of  the  first 
page  are  considered  Main  Programs  as  described  in  section  3.10.1 
above. 

There  is  am  internal  paging  schene  as  narked  by  the  nunbers 
in  the  upper  right  corner  of  eaich  page.  An  index  after  the  last 
page  of  the  chart  shows  where  a  routine  amd  its  calls  are  first 
defined.  If  a  routine  has  no  page  reference,  it  either  naLkes  no 
calls  or  is  am  external  routine.  A  continuation  box  on  the  end 
of  a  tree  linb  shows  where  that  the  tree  continues  on  the  page 
nunbered  nentioned.  A  number  in  a  box  with  a  routine  name 
points  to  the  page  where  the  routine  is  further  defined  within 
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ABS 

ACTRSV . 21 

ADDCHK . 43 

ADDFRM 

ARRANGE . 41 

ASSIGN . 94 

ATOF 

ATOI 

BLDMOD . 79 

BLDNODE . 39 

BLDSUB . 23 

BLEN 

BSCODE . 35 

CALCSTAT . 69 

CALLOC 

CCONV . 125 

CDMESQY . 120 

CES . 120 

CESPS 

CHKARY . 65 

CHKFLD . 63 

CHKFRM . 43 

CHKGRP . 86 

CHKSIZE . 76 

CLOSEGAP . 14 

CLRNDP . 86 

CLSFIL . 90 

COBCONV . 129 

COBES . 128 

COBESPS . 91 

COBPE . 76 

COPFLD 

COPYNODE . 80 

CPE 

CSTASH . 83 

CTLRSV . 20 

DASH . 92 

DATAGEN . 78 

DBFREAD . 35 

DCLINDX . 53 

DELFLD 

DELNODE . 14 

DOINDEX . 109 

DRAWLEV . 108 

ENDGEN . 75 

ERROR . 5 

ERRPRO 


ESCPY 

ESPSMAP . 91 

ESPSMAP/ INDENT. . .100 

FATAL . 42 

FCLOSE 

FD . 106 

FGETS 

FILELNK . 78 

FLANCI . 6 

FLDRSV . 20 

FLDTYP 

FNDATT . 84 

FNDFRM . 18 

FOPEN 

FPRINTF 

FPUTS 

FREE 

FRMPDAT . 54 

FRNTND . 4 

FSEEK 

FTELL 

FWRITE 

GDATA 

GEN . 22 

GENAA . 24 

GENAAL . 24 

GENACT . 24 

GENAE . 57 

GENAH . 57 

GENAI . 74 

GENAL . 36 

GENAP . 54 

GENAQ . 56 

GENAR . 55 

GENAS . 72 

GENAT . 73 

GENBEG . 22 

GENCHG . 34 

GENDB . 49 

GENDOA . 36 

GENDS . 49 

GENFP . 47 

GENFS . 46 

GENFSD . 33 

GENINS . 49 

GENMAIN . 22 

GENNDP . 48 
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GENPAG . 13 

GETC 

GETCOL . 92 

GETFILE . 5 

GETFIT . 61 

GETLOWLEF 

GETLOWRIT 

GETPAR . 59 

GETPTH . 19 

GETSIZE . 61 

GETTBL . 88 

GETTOP 

GETUPLFT 

GFLDPT . 64 

GRP/MAIN . 2 

HASDATA . 23 

HASITEM . 32 

HASLOWER 

HBALANC . 62 

HRW/MAIN . 3 

INDENT . 75 

INITAL 

INITFP 

INSERT . 92 

INSMAP 

INSRSV . 21 

INSWS . 105 


ISALNUM 
IS ALPHA 
ISDIGIT 
ISOPNE 
ISSPACE 


MAKACT . 10 

HAKES . 120 

MAKES/CNUMPIC. . . .129 

MAKES/ INDENT . 120 

MAKES/NUMPIC . 128 

MAKFLD 

MAKINS . 101 

HAKINT . 10 

MAKPS . 112 

MAKQR . 45 

MAKSTR . 64 

MAKVH . 93 

MAKWHES . 113 


MAKWHES / COBWHES  .122 
MAKWHES / CVHES 


MAKWHES/NUMPIC. . . 122 

MALLOC 

HAP 

MAPDB . 51 

MAX 

MEMCMP 

MEMCPY 

MEMSET 

MIN 


MKINC . 32 

MKPOS . 27 

MLPFRM . 18 

MODPAGE . 41 

MOVCLD . 60 

MOVECLD . 61 

MYALLOC . 10 

NDMLGEN . 37 

NDMLLAB . 77 

NDMLLNK . 93 

NEXTLEV 

NULBLK . 76 

01  SCR 

OPNFIL . 89 

OUTSCR 

PAGNODE . 80 

PAGTREE . 61 

PEMAP . 76 

PMSGLC 

PMSGLS 

PRINTF 

PRNT . 1 

PRNTREE . 81 

PROCGEN . 77 

PSESMAP 

PSSTRC/COBSUB. ...  103 

PSSTRC/CSUB . 102 

PSSTRC/ INDENT . 93 

PTHPTR 

PUTATT 

PUTC 

PUTCUR 

PDTLIN . 107 

READDB . 35 

READTREE . 39 

REPOS . 40 

RSETNDP . 50 

RSETSTAT . 54 
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RWEXPD . 17 

RWOPN . 12 

RWSP/FIXFRH . 17 

SAVEES . 126 

SELECT . 76 

SELGEN . 76 

SELLEN . 106 

SELMAP . 91 

SELOPN . 71 

SELRSV . 31 

SELWHR . 56 

SELWS . 104 

SETNDP . 52 

SORT . 117 

SPLICE . 40 

SPLITNODE . 41 

SPRINTF 

STATRSV . 20 

STDCODE . 58 


STRASN 

STRCAT 

STRCHR 

STRCMP 

STRCPY 

STRIPLEV . 107 

STRLEN 

STRNCMP 

STRNCPY 

STRSPN 

STRUPC 

SYSMSG 

TERMFP 

TOUPPER 


TRGRSV . 21 

TRMNAT 

TRMNDML 

UNGETC 

UQFOR . 36 

UQPTH . 30 

USING . 77 

VISITA . 68 

WARNING . 15 

WINRSV . 19 

WRTEXP . 96 

WRTFRM . 11 

WRTFRM/DBFCLOS. . . .44 
WRTFRM /FORMAT 


WRTFRM /TBFCLOS. . . . 29 


WRTFRM  /  WRTDBF . 44 

WRTFRM  /  WRTFLD . 28 

WRTFRM /WRTTBF . 29 

WRTFRM  /WRTTXT . 16 

YYERROR 

YYLEX . 98 

YYPARSE . 6 
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3.11  Program  Listings  Comments 

This  information  is  contained  in  the  Nodule  Descriptions  in 
section  3.10. 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 


4.1  Introduction  and  Definitions 


"Testing"  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advance,  and  a  sequence  of  test  steps  may  be 
specified.  "Debugging"  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error. 

"Antibugging"  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  them  more  noticeable  to  the 
programmer  and  the  user.  In  other  words,  as  much  error  checking 
as  is  practical  and  possible  in  each  routine  should  be 
performed . 

4.2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  "ant ibugging" 
facilitate  this  testing  by  exposing  and  addressing  problem  areas 
before  they  become  coded  "bugs." 
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